home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 2004 May / SGI IRIX 6.5 Applications 2004 May.iso / relnotes / java_plugin / ch2.z / ch2
Encoding:
Text File  |  2004-04-07  |  15.6 KB  |  529 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to _I_R_I_X _A_d_m_i_n:
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g. The information listed
  12.        here is product- and release-specific; use it with the
  13.        installation guide to install this product.
  14.  
  15.        2.1  _J_a_v_a__P_l_u_g_i_n__S_u_b_s_y_s_t_e_m_s
  16.  
  17.        Java Plugin includes these subsystems:
  18.  
  19.        _j_a_v_a__p_l_u_g_i_n._m_a_n._m_a_n           Man page documentation,  Java
  20.                                      plugin "ControlPanel"
  21.                                      (ControlPanel.html) and
  22.                                      "Welcome" (Welcome.html)
  23.  
  24.        _j_a_v_a__p_l_u_g_i_n._m_a_n._r_e_l_n_o_t_e_s      Release notes for the plugin
  25.  
  26.        _j_a_v_a__p_l_u_g_i_n._s_w._b_a_s_e           Java Jar files associated with
  27.                                      this release
  28.  
  29.        _j_a_v_a__p_l_u_g_i_n._s_w._b_i_n_a_r_i_e_s       Java VM o32 MIPS ABI Execution
  30.                                      Software as well as runtime
  31.                                      libraries
  32.  
  33.        _j_a_v_a__p_l_u_g_i_n._s_w._n_e_t_s_c_a_p_e__v_3__l_i_n_k_s Symbolic Links for
  34.                                      Navigator less than version
  35.                                      4.0
  36.  
  37.        _j_a_v_a__p_l_u_g_i_n._s_w._p_l_u_g_i_n         Java JDK 1.1.8 o32 MIPS ABI
  38.                                      Plugin Software
  39.  
  40.        _j_a_v_a__p_l_u_g_i_n._s_w._s_w_i_n_g_1_0_2       Java Jar files associated with
  41.                                      Swing 1.0.2
  42.  
  43.        _j_a_v_a__p_l_u_g_i_n._s_w_3_2._b_i_n_a_r_i_e_s     Java VM n32 MIPS ABI Execution
  44.                                      Software as well as runtime
  45.                                      libraries
  46.  
  47.        _j_a_v_a__p_l_u_g_i_n._s_w_3_2._p_l_u_g_i_n       Java JDK 1.1.8 n32 MIPS ABI
  48.                                      Plugin Software
  49.  
  50.  
  51.        2.2  _J_a_v_a__P_l_u_g_i_n__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  52.  
  53.        This section lists the subsystems (and their sizes) of Java
  54.        Plugin.
  55.  
  56.        If you are installing this product for the first time, the
  57.        subsystems marked `default' are the ones that are installed
  58.        if you use the `go' menu item.  To install a different set
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        of subsystems, use the `install,' `remove,' `keep,' and
  75.        `step' commands in _i_n_s_t to customize the list of subsystems
  76.        to be installed, then select the `go' menu item.
  77.  
  78.        Note:  The listed subsystem sizes are approximate. Refer to
  79.               _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g for
  80.               information on finding exact sizes.
  81.  
  82.        Subsystem Name                               Subsystem Size
  83.                                                     (bytes)
  84.        _j_a_v_a__p_l_u_g_i_n._m_a_n._m_a_n (default)                     17166
  85.        _j_a_v_a__p_l_u_g_i_n._m_a_n._r_e_l_n_o_t_e_s (default)                  296
  86.        _j_a_v_a__p_l_u_g_i_n._s_w._b_a_s_e (default)                     75141
  87.        _j_a_v_a__p_l_u_g_i_n._s_w._b_i_n_a_r_i_e_s (default)                 62588
  88.        _j_a_v_a__p_l_u_g_i_n._s_w._n_e_t_s_c_a_p_e__v_3__l_i_n_k_s (default)            0
  89.        _j_a_v_a__p_l_u_g_i_n._s_w._p_l_u_g_i_n (default)                   68428
  90.        _j_a_v_a__p_l_u_g_i_n._s_w._s_w_i_n_g_1_0_2 (default)               2001666
  91.        _j_a_v_a__p_l_u_g_i_n._s_w_3_2._b_i_n_a_r_i_e_s (default)               63948
  92.        _j_a_v_a__p_l_u_g_i_n._s_w_3_2._p_l_u_g_i_n (default)                 62476
  93.  
  94.  
  95.  
  96.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  97.  
  98.  
  99.        This section lists the installation method for the Java
  100.        plugin subsystems.
  101.  
  102.        Subsystem Name                     Method of Installation
  103.        _j_a_v_a__p_l_u_g_i_n._m_a_n._m_a_n                IRIX
  104.        _j_a_v_a__p_l_u_g_i_n._m_a_n._r_e_l_n_o_t_e_s           IRIX
  105.        _j_a_v_a__p_l_u_g_i_n._s_w._b_a_s_e                IRIX
  106.        _j_a_v_a__p_l_u_g_i_n._s_w._b_i_n_a_r_i_e_s            IRIX
  107.        _j_a_v_a__p_l_u_g_i_n._s_w._p_l_u_g_i_n              IRIX
  108.        _j_a_v_a__p_l_u_g_i_n._s_w._s_w_i_n_g_1_0_2            IRIX
  109.        _j_a_v_a__p_l_u_g_i_n._s_w._n_e_t_s_c_a_p_e__v_3__l_i_n_k_s   IRIX
  110.        _j_a_v_a__p_l_u_g_i_n._s_w_3_2._p_l_u_g_i_n            IRIX
  111.        _j_a_v_a__p_l_u_g_i_n._s_w_3_2._b_i_n_a_r_i_e_s          IRIX
  112.        _j_a_v_a__p_l_u_g_i_n._s_w_3_2._p_l_u_g_i_n            IRIX
  113.  
  114.  
  115.        The system administrator should install Navigator using the
  116.        _i_n_s_t program.  Refer to _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n
  117.        _a_n_d _L_i_c_e_n_s_i_n_g for complete installation instructions.
  118.  
  119.        The default location for Navigator Java plugin is in the
  120.        Navigator directory tree.
  121.  
  122.        Navigator checks for plugin modules in the plugins directory
  123.        /var/netscape/communicator/plugins or /var/netscape
  124.        /communicator/plugins32 depending on whether the browser is
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        the o32 or n32 version.
  141.  
  142.        The user can also add their own plugins into
  143.        $HOME/.netscape/plugins (o32) or $HOME/.netscape/plugins32
  144.        (n32) directories.
  145.  
  146.  
  147.  
  148.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  149.  
  150.  
  151.        This software supports both the o32 and n32 MIPS ABI's, and
  152.        the o32 and n32 portions of this software  depend on the o32
  153.        and n32 portions of our java_eoe product, respectively. Both
  154.        are installed by default, so you must explicitly choose not
  155.        to install one that either you do not want or you do not
  156.        have the prerequisite software for.
  157.  
  158.        For o32 you need at least version 3.0.1 of java_eoe, and for
  159.        n32 you need at least version 3.1.  But in either case, we
  160.        strongly suggest that you install our latest release,
  161.        version 3.1.1, from
  162.  
  163.              http://www.sgi.com/Products/Evaluation/#jdk_3.1.1
  164.  
  165.        As well you will need to install java_plugin.sw.base and
  166.        java_plugin.sw.swing102.
  167.  
  168.        If you are running a version of Navigator earlier than 4.0,
  169.        make sure you install the java_plugin.sw.netscape_v3_links
  170.        subsystem.
  171.  
  172.        For Navigator 4.73+ they have being built using the n32
  173.        binaries only and will require only the n32 version of the
  174.        libraries.
  175.  
  176.        The following table shows the common dependencies between
  177.        the o32 and n32 versions of the plugins
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.          --------------------------------------------------------
  207.         | PreRequisite Common Modules                            |
  208.         |                                                        |
  209.         |                   JDK 3.1.1 or 3.1                     |
  210.         |                   java_plugin.man                      |
  211.         |                   java_plugin.sw                       |
  212.         |                   java_plugin.sw.base                  |
  213.         |                   java_plugin.sw.swing                 |
  214.         |                                                        |
  215.          ---------------------------- ---------------------------
  216.         | o32 ABI                    | n32 ABI                   |
  217.          ---------------------------- ---------------------------
  218.         | java_plugin.sw.binaries    | java_plugin.sw32.binaries |
  219.         | java_plugin.sw.plugin      | java_plugin.sw32.plugin   |
  220.         | java_plugin.sw.netscape_v3 |                           |
  221.         |  _link  (Netscape V3 only) |                           |
  222.         |                            |                           |
  223.          ---------------------------- ---------------------------
  224.  
  225.        The software can be used with Irix 6.2 through to 6.5 and
  226.        Navigator versions 3.0 and later.
  227.  
  228.  
  229.        2.5  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s
  230.  
  231.        Navigator has user specific configuration file. Each user
  232.        can specify Navigator specific parameters in
  233.        ~/.java.properties. The specific parameter that effects the
  234.        Java plugin is the key/value pair "javaplugin.jre.path". The
  235.        value is the JRE path used by the Java plugin.
  236.  
  237.  
  238.        2.6  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  239.  
  240.  
  241.  
  242.        2.6.1  _I_f__y_o_u__a_r_e__n_o_t__a__s_y_s_t_e_m_s__A_d_m_i_n_i_s_t_r_a_t_o_r
  243.  
  244.  
  245.        If you have installed Navigator or the plugin in a
  246.        nonstandard location, you may need to go into Navigator's
  247.        "plugin" directory (or into your personal .netscape/plugins
  248.        directory if you do not have root access) and run the
  249.        following command:
  250.  
  251.          ln -s <plugin-installation-
  252.        location>/var/netscape/communicator/plugins/javaplugin.so .
  253.          ln -s <plugin-installation-
  254.        location>/var/netscape/communicator/plugins32/javaplugin.so
  255.        .
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        Then you must make sure the following environment variable
  273.        is set whenever you run Navigator:
  274.  
  275.          setenv JAVA_PLUGIN_ROOT <plugin-installation-location>
  276.  
  277.          (See Environment Variables section)
  278.  
  279.  
  280.        2.6.2  _I_n__o_r_d_e_r__t_o__u_s_e__j_a_v_a___e_o_e__f_r_o_m__a__n_o_n_s_t_a_n_d_a_r_d__l_o_c_a_t_i_o_n
  281.  
  282.  
  283.  
  284.  
  285.        In order to use java_eoe from a nonstandard location, you
  286.        must make sure the JAVA_HOME environment variable is set
  287.        such that $JAVA_HOME/bin contains the various Java tools.
  288.        For example:
  289.  
  290.          setenv JAVA_HOME <java_eoe-installation-location>/usr/java
  291.  
  292.          (See "Finding further Java runtime binaries")
  293.  
  294.  
  295.  
  296.        2.6.3  _I_f__y_o_u__a_r_e__b_e_h_i_n_d__a__f_i_r_e_w_a_l_l
  297.  
  298.  
  299.        If you are behind a firewall and need to access sites
  300.        outside it, you need to manually set your HTTP proxy
  301.        correctly in Navigator.  Setting a SOCKS Host is not
  302.        sufficient.
  303.  
  304.        Quit Navigator.
  305.  
  306.        Restart Navigator.
  307.  
  308.  
  309.  
  310.  
  311.        2.7  _E_n_v_i_r_o_n_m_e_n_t__V_a_r_i_a_b_l_e_s
  312.  
  313.  
  314.        This section documents the minimal set of variables
  315.        required.
  316.  
  317.  
  318.        2.7.1  _S_e_l_e_c_t_i_n_g__o_3_2__o_r__n_3_2__A_B_I__l_i_b_r_a_r_i_e_s
  319.  
  320.  
  321.        Netscape will attempt to run the n32 version of plugin by
  322.        default.  If you did not install the n32 portion of this
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.        software, or if you need to run applets that contain o32
  339.        native code, you will need to make sure the following
  340.        environment variable is set whenever you run Navigator:
  341.  
  342.          setenv SGI_ABI -o32 or
  343.          setenv SGI_ABI -32
  344.  
  345.        Running applets containing o32 native code and applets
  346.        containing n32 native code in the same Navigator process is
  347.        not supported at this time.
  348.  
  349.  
  350.        2.7.2  _S_e_l_e_c_t_i_n_g__p_l_u_g_i_n__l_i_b_r_a_r_i_e_s__p_a_t_h
  351.  
  352.  
  353.        If Navigator version is less 4, the plugin should be
  354.        installed in /usr/local/lib/netscape
  355.        (java_plugin.sw.netscape_v3_links).
  356.  
  357.        The following environment variables are used by Navigator to
  358.        search for the plugin directory. Each are searched for
  359.        plugins in the order given. When a plugin is found the other
  360.        search paths and environment variables are not used.
  361.  
  362.         _N_P_X__P_L_U_G_I_N__P_A_T_H  is a path of directories to find the
  363.                          directories holding plugins, find the
  364.                          first of those that has a ../java
  365.                          directory. This is used to find any plugin
  366.                          not specifically the java plugin.  for
  367.                          example
  368.                          NPX_PLUGIN_PATH=$HOME/yourplugins:/var/netscape/communicator/plugins
  369.                          will find the system plugins as well as
  370.                          your own private plugins.
  371.         _J_A_V_A__P_L_U_G_I_N__R_O_O_T is prepended to
  372.                          /var/netscape/communicator. This is the
  373.                          variable generally used to find the
  374.                          appropriate java plugin path.
  375.         _M_O_Z_I_L_L_A__H_O_M_E
  376.  
  377.  
  378.        2.7.3  _S_e_l_e_c_t_i_n_g__g_r_e_e_n__o_r__n_a_t_i_v_e__t_h_r_e_a_d__p_a_c_k_a_g_e_s
  379.  
  380.  
  381.        If no environment variable is specified the default is to
  382.        use green threads. To use native threads set the environment
  383.        variable, "THREADS_FLAG" to "native". Generally native
  384.        threads provide a performance boost over green threads.
  385.  
  386.        Silicon Graphic's native threads are implemented using the
  387.        POSIX threads (pthreads) implementation which is available
  388.        on IRIX 6.2 and higher.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.        2.7.4  _F_i_n_d_i_n_g__f_u_r_t_h_e_r__J_a_v_a__r_u_n_t_i_m_e__b_i_n_a_r_i_e_s
  405.  
  406.  
  407.        If no value is found the jre will be searched by utilising
  408.        the following environment variables.
  409.  
  410.         _J_R_E__H_O_M_E         is used to determine the jre root
  411.         _J_D_K__H_O_M_E
  412.         _J_A_V_A__H_O_M_E
  413.         _J_A_V_A__P_L_U_G_I_N__R_O_O_T is prepended to /usr/java
  414.  
  415.        To verify the jre path, Navigator will try to find
  416.        "_l_i_b_j_a_v_a._s_o" in all of the paths below:
  417.  
  418.  
  419.         {jre root}/lib32/sgi/green_threads
  420.         {jre root}/lib32/sgi/native_threads
  421.         {jre root}/lib32/sgi
  422.         {jre root}/lib/sgi/green_threads
  423.         {jre root}/lib/sgi/native_threads
  424.         {jre root}/lib/sgi
  425.  
  426.        If the java runtime is not found and java is installed the
  427.        plugin will used the installed JRE.
  428.  
  429.  
  430.  
  431.        2.7.5  _S_c_r_i_p_t__c_h_a_n_g_e_s__t_o__a_p_p_l_e_t__c_o_d_e
  432.  
  433.  
  434.        To deploy the Java Plugin with Navigator you must convert
  435.        the <APPLET> tags in the HTML file to <EMBED> tags.
  436.  
  437.        The actual mapping between the <APPLET> tag and the <EMBED>
  438.        tag is specified in the Java Plugin HTML Specification from
  439.        Sun Microsystems.
  440.  
  441.        The attribute type in the EMBED tag is used for identifying
  442.        the type of the Java executable, such as an applet or a
  443.        Bean. When Navigator renders this attribute in the EMBED
  444.        tag, it will try to load Java Plugin into the browser. By
  445.        specifying the type attribute, Java Plugin will know how to
  446.        initialize the Java executable. Using the HTML <EMBED> tag,
  447.        web page authors can cause Plugins to be run as part of a
  448.        web page.
  449.  
  450.        Check the Sun site
  451.        (http://java.sun.com/products/plugin/converter.html) for the
  452.        "HTML converter application". This is a java application
  453.        that can convert HTML applets mappings to Java plugin
  454.        mappings.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                   - 8 -
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.